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POCKET REFERENCE 



GUIDE TO COMMODORE'S 



2001 PET 





MISC. INFORMATION 



USER I/O PORT 



NAME 


DEC. 


HEX. 


COMMENTS 


Dgta Djreciton Register 


59459 


E843 


1 = Output. = input 








PAO - PA7 


I/O Regtster w/o 


59471 


E84F 




handshake 








i/0 Register with 


59457 


E841 




handshake 








Auxiliary Cor^trol Register 


59467 


E84B 


Sst to 1 6 for ffQB njnniriQ 








shift registar 


Rea(±/Write Counter 


59464 


E84B 


Varies shift rate of data 








through CB 2 


Seriai i/0 Shift Register 


59466 


Ee4A 


Write or read shtft register 



Locations 59467. 59464. 59466 are used to generate "CB2 ' SGur>d 
on the PET. NOTE: Location 59467 must be' reset to zero for cassette 
to function properly. 



USEFUL MEMORY LOCATIONS 

2001-8 2001-16, -32 

NAMEOFLOC. DEC HEX DEC HEX BYTES COMMENTS 



Video Memory 


32763 


8000 


32768 


8000 


1000 




Top of Memory 


134 


3S 


52 


34 


2 


LO. Hi BYTE 


Start of Variables 


124 


7C 


42 


2A 


2 


LO, Hi ByjE 


Start of Strings 


130 


82 


4S 


30 


2 


LO. Hi SYTE 


Start of Array Tbi. 


126 


7E 


44 


2C 


2 


LO. Hi BYTE 


iRQRAM Vector 


537 


213 


144 


90 


2 


LO, Hi BYTE 


NMI HAM Vector 


None 


r^one 


148 


94 


2 


LO. Hi BYTE 


BRK HAM Vector 


539 


216 


146 


92 


2 


LO, Hi BYTE 


No, of Dropout 


630 


276 


192 


CO 


2 


Pass 1, Pass 2 


Errors X 2 












Ernirs 


Cassette Buffer 1 


634 


27A 


634 


27A 


192 




Cassette Buffer 2 


826 


33A 


B26 


33A 


192 




USR Ftoating 


176 


60 


94 


5E 


7 


EMIiflMfVIMS 


Point Acc. 














Keystroke VaiuE 


516 


203 


151 


97 


1 


26S = No key 
pressed 


Keystroke Buffer 


527 


20 F 


623 


26F 


10 


Keys encoded 
by row St coi. 


Indent into 


525 


20D 


1 58 


9E 


1 


^ of characters' 


Keystroke Buffer 












m buffer 



Machine Languags Routines & Important 
Hardware Locations 





HEX 




Print character in flegister A to screen 


FFD2 


Aii PETS 


Get a character from keyboard 


FFE4 


Aii PETS 


Input a character from keyboard 


FFCF 


Aii PETS 


Prints a carnage return, iine feed 


FDDO 


(not in 2001-8) 


ICR, LF) 






Pnnt a space 


FDCD 


(not in 2001-8) 


Pnnt a byte in Register A 


E775 


[not in 2001-8) 


inpul a byte m Register A 


E7B6 


(not in 2001-8) 


ASCII to Hex in Register A 


E7E0 


(not in 2001-E) 



Entry for machine language moriitor; SYS (10241 or SYS (64785) 

on 2001-16, -32 
Graphics/Lower Case Select POKE 69468, 12 = Graphics 

POKE 59468, 14 = Lower Case 
NOTE: PET Modeis 2001-16. -32 behave differently m the iower case 
mode than Modal 20D1-8 (shifted end unshifted alpha ere reversed). 
Casetta Motor Control: POKE 59411. 53 Turns Molot On 
POKE 5941 1. 61 Turns Motor Off 
CRT blanking (2001-8 only): POKE 59409. 62 Turns Screen Oil 
POKE 59409. 61 Turns Screen On 



GENERAL INFORMATION 

Numefic Accuracy; 9 digits 

tumeric Range: ± 1.70141 ia4E + 38 [ ± 32767 for integars} 

± 2 938735B7E - 39 
Numarlc, Integer, St Array Variable Ranga: 

Valid variables are arv alpliabetic (A-Z) character optionally followed by o^her 
afphanumenc (A-Z. 0-9) characters. Keywords carinot be used within variable 
names, and only ttie first two characters are recognized. 

STRING FUNCTIONS 

FUNCTION EXAMPLE DEFINITION 

ASC 100 N = ASC (AS) Returns the ASCII value otlhe first 

charactEt in the stnng 

CHflS 1001$ = CHRS IM) Returns the character Bquivalenl 

of the ASCII Malus N. 

LEFTS 1 00 1$ = LEFTS Returns N laftmosi characteis of 

(AI. M the string. 

LEN 100 N = LEW (ASI Returns number o( characters in 

the string. 

MIDS 100l£ = MtDS Returns Y characters, starting from 

(ASJC.Yl theXth cheractar of the string 

RIGHTS 5 00 IS = RIGHTS Returns M rightmost ctiaracteis 

(A$,Nt of the string. 

STRS 100 IS = STRS (N) Rsturnsstnng value of the number. 

VAL 100N=VALtAS) Returns humeri c value of the string. 

SPECIAL SYMBOLS 

SYMBOL EXAMPLE FUNCTION 

100 IS = "ABC Strine Deiimilei 

S 100IS = ' XVZ ' String Identifier 

% 100a%=iNT[Nl integer (rjentifer 

100X = V = 4 Aiiows multiple statement iines, 
100 PRINT X.V Prints numbers separated bv 
3 spaces 

1 00 PR i MT AS ; BS Prints strings concatenated 
too PRiNTX. V Prints numbers at tab stops 
10. 20. 30. and 40. 

BASIC ABBREVIATIONS 

Most BASIC words can be abbreviated using the first letter of (he word and the 
secoiid iettar shifted. ForsKampie: List = L I. RIGHTS =Ri. etc. In some cases, 
there can be abbreviations that could represent more than one word le.g. STEP 
and STOP). A list of these exceptions follows: 

RESTORE =REs STEP = STe 

GOSUB = GOs LEFTS = LEf 

CLOSE = CLo STRS = STr 

RETURN = REt PRINT = ? 

INPUT* = In PRINT* = Pr 

TAB) = Ta SPC( = Sp 



INPUT HAS NO ABBREVIATION. 



MATHEMATICAL 
FUNCTIONS 



STAIStDARD FUNCTIONS 

FUNCTION EXAMPLE DEFINITION 

ABS (X) 1 00 B = ABS lA) Reiurns itie absolute value of the 

argument 

£XP tX] 1 00 H = EXP lAI Returns the vslue of the constan! 

V rai^d to the argument 

INT (X) too R " INT jAl Returns the largest integer Eess 

than orequal to A. 

LOG (XI 100 R = LOG (A) Returns ih>H logsrtthm of the 

argument to the base 'e' 

RND (X> 100 R =^ RND iA) Returns a rartdom number 

from □ to 1 \f: 
A i Random numbers are 
equal. 

A = Same sequence of random 

numbers. 
A ) Different sequence of random 

numbers on avery execution of 

RND 

SGN (XI lOO R =SGN 1A| If argument < 0. R= - 1- 

If argument - 0. R-0. 
If argument JO. R=T. 

SQR (X) 100 R = SQR (A) Returns the square root of A 

TRIGOKStOMETRIC FUNCTIONS 

ATN {X) 1 QD R = ATN (A) Returns the arctangent of the 

argument jin radiarts) 

COS (X) 1 00 R =COS i A) Returns the cosme of the 

argument {in radians) 

SSN (X) 100 R -SIN I A) Returns the sine of the 

argument [in radians). 

TAN iX) 100 R - TAM (A) Returns the tangant of The 

argument {in radians]. 

USER-DEFINABLE FUNCTIONS 

DEF FN Allows the user to defme functions The newly defined 
function's name wilt be "FN " followed by any legal 
variable name Lmitations. stnng functions are no) 
ailowed, Junction can only have one argument, and 
the function is restricted to one line 

100 DEF FNCR [N) ^ N t {V3) Function definition 

(lakes the cube root) 

Functian name 

Dummy vanabtk... 



400 A = FNCR {31 Using iha Function 

(A Will equal 2) 



STATEMENT EXAMPLE 

SAVE SAVE ■"FILE". T 

SPC TOPRIhtTSPC lA) 

TAB 10 PRINTTAB (A) 



DEFINITION 

Saves current progr^rri m memorv 
to logical file T and gives il the name 
"FILE'" 

Prints A spaces 

Tabs cursor lo position 
A + 1 on the CRT 



VERIFV 



VERIFY 



VERIFY "FILE", T 



Compares next encouniered 
program on buill m cassette wiih 
program wiihin memory 
Compares specified file name on 
togica! File T wuh program withm 
rtiemory 



1 50WAIT X.Y.Z Stops BASIC program flow until 
contents of memory looaiion X, 
anded wilh variable V, and exdusiue 
ored With variable Z is not equal to 
zero 1^ IS optional and defaults to 
zero) 

I/O DEFAULTS & 
PRE-ASSIGNED IEEE 
DEVICE ADDRESSES 



PRIMARY 

DEVICE ADDRESSES 

= Keytioard 
'1 = PaneJ Mounted Cassette 

2 = Optional External Cassette 

3 = Vi(Jeo Screen iCRTI 
8l = Floppy Disk Drive 
4-30' External IEE£4a8 

Device Addresses 

' Indicates Default VaEue 



SECONDARY ADDRESSES 
FOR CASSETTES 



3-31 



Tape being opened for a 
Tape being opened for a 
Tape tjeing opened for a 

With an "end of tape'" 

being forced when the 

closed 

= Other lE£E4a8 Secondary 
Addresses 



Read " 

"Write" 
^'Wnte" 
header 
i\\e is 



STATUS BYTE (ST) 
NOMENCLATURE 



ST 
BIT 
POS. 


ST 
NUM. 
VALUE 


CASSETTE 
READ 


IEEE 
R/W 


TAPE VERIFV 
& LOAD 





1 




Timeoul on Write 
ILiSTener) 




1 


2 




Tirneout on Read 
(Talker) 




2 


4 


Short Block 




Short Blocfc 


3 


8 


Long Block 




Lang Block 


4 


IS 


Unrecouar^bJe 
Read Error 




Any Mismatch 


5 


32 


Ctiecksum Error 




Checksum Error 


6 


64 


End o( File 


EOl Line went low 
on last byte trans 




7 


128 


End of Tape 


Device not present 


End of Tape 



STATUS BYTE: 



BIT POSITIONS 

|7|6|5|4|3|2|TM 



OPERATORS 



RELATIONAL 


OPERATOR EXAMPLE 


RESULT 


EQUAL 




9=7 


FALSE 


LESS THAN 


( 


5 { 10 


TRUE 


GREATER THAN 




6 >10 


FALSE 


LESS THAN OR EQUAL 


< = 


4 < = 4 


TRUE 


GREATER THAN OH EQUAL 


) = 


4 > =3 


TRUE 


NOT EQUAL 


( > 


4 i )8 


TRUE 


D nm CAM 








AND • 


AND 


1 ANDO 





OR + 


OR 


1 ORO 


1 


NOT 


NOT 


N0T1 





AfirTHMETIC 








ADDITION 




4+3 


7 


*ll J RTnArTlflN 




1 2 ~ 9 


3 


MULTIPLICATION 




4 '4 


16 


EXPONENTIATION 


t 


■ 4 t2 


16 


DIVISION 


/ 


12 .'3 


4 


NEGATION 1A = 3) 




-A 


-3 


STRING 








CONCATENATION 


+ 


■■A" + -B" 


"AB' 



ORDER OF OPiRATtONS: Paranthasis, Exponentiatiar>r Negation Mul- 
tiplication & Division {from left to right). Addition & Subtraction (from left to 
right), Relational Operators, Mot, And, Or. 

SPECIAL VARIABLES 



POS [ ) Returns position of cursor on CRT 
FREiO) Readonly variable, ? FRE(0)ratum5 
free bytes of memory 
Tl£ IntErnal tima of day cioctt "HHMMSS" 

ji,e,''O24500"isZ:45AMf 
Tl Read only variable counting 60tbs 

of Seconds since power up 
ST Read only I/O status byte [see I/O section} 
JT Mathernatical constant PI =3.1415927 



PET MONITOR 
COMMANDS 



M Maddr1,addr2 

R R 

G Gaddrl 

L L"NAME\#1 

S S 'NAME", rfl. 



addr1, addrZ 
addrlxK )^x 
.addr 1 XX Kx Kx 



Displays memory from anklri 
to addr2 

Displays 6502 registers 
Begin exacution of machine 
language program at addrV 
Loads a machine languaga 
program called "NAME" from 
cassette T, 

Saves & machine language 
program to cassarte 1 fron^addrl 
toaddr2 calted "NAME" 
Modify memory m format thai 
was displayed with .M comrriand, 
Modify registers ir^ format that 
was displayed with .R command. 



BASIC COMMANDS 



COMMAND EXAMPLE DEFINITJON 

C Lfl CL R CI ea rs al I refe re n ces to va riab I es 

and program control statements [all 
variables equal zero or r^ulL], 



CONT CONT Corminyss program after a stop, or 

use of stop key. Invalid after an error, 
editing. CLR.or NEW. 



LIST LIST Lists entire program. 

LIST— A Lists program up to fine A. 

LISTb — Lists program from line B. 

LISTX-Y Lists program from line X to line V, 



NEW NEW Dears the present BASIC program 

from memory and clears all vanables 
torero or null. 



RUN RUN Starts program, execution from first 

line of program. 
RU N W Starts program execution from line W- 



STATEMENTS: DECLARES 
& VARIABLE 
ASSIGNMENTS 



STATEMENT 

DATA 



EXAMPLE 

10 DATA1,2.3.4 



20 DATA 
UP, DOWN 
30 DATA"1.r' 
"LOOKOUT- 



OEFtNITION 

Spacifies data to be read via the 
"READ" commend. Data is read from 
(eft to right. 

Strings need not be surrounded 

by quotes unless they contain spaces, 

commas, colons, or graphics. 



DIM 



25 DI^UMOK 

30 DIMASi^.l 1) 
45 DSMlK.20,21 
50 DJMaE(L4.M) 



Dimensions an array of a specified 
type of variable to a specified amount 
of elemflr>ts jzeroth element 
inotuded) 



LET 1 LET U = 7 Assigns the number 7 to the floating 

point variable U. 
20 LET u% = 7 Assigns the number 7 to the integer 
variable U%. 

30 LETlJ£="7" Assigns the string "7" to the string 
variable US. 

40 Y = X - 3 Assigns the value of the nugiertc 

expression to tha uanabte Y 
[Note: LET IS optional) 



STATEMENT EXAMPLE 

RESTORE 50 RESTORE 



DEFINITION 

Resets dara pomter to the fi rst data 
statement in the program. 



10 REMVER 1.5 DefinES tha following characters in the 
linE as a remarit or comment which 
is n OR -ex acuta hie. 



STATEMENTS: 
PROGRAM CONTROL 



STATEMENT EXAMPLE 

END 9O00 END 



DEFINITION 

Ends program eKecution. 



FO R ' NEXT 1 FOR A - Sets up a loop which executes the 

NTOP STEPR statements between lines to and 50 
50 NEXTA \{P'H) + 1) /R times 

GOSUB 10 GOSUBM Transfers program flow to the 

subroutine at line M. Program flow 
resume? st line immediately after 1 
whan the subroytine executes a 
RETURN 



10 GOTOV 



Transfers program flow to Hue Y 



IF* THEN 



25 IFA( >B 
THENA = A + 1 



30 IFAt )B 
THEN 500 
30 IFA< >B 
GO TO 500 



tf the condition of the statement 
between the IF and the THEN is 
true the statement following the THEN 
is executed. Otherwise the next line 
Is executed, 

Trgr^sfers program flow to line 
5Q0 if condition is true, otherwise 
executes next line. 



ON - GOSUB 



70 ONH GOSUB 
100.200,300 



Transfers program flow to a 
subroutine at lines 100. 200. or 
300 deper^tJing on the value of the 
indeK variable H. 



ON • GOTO 



70 ON H GOTO 
too, 200. 300 



Transfers program flow to line 
number 100. 200. or 300 depend- 
ing on the index wariahle H. 



STOP 
SYS 



100 RETURN 



200 STOP 



150 SYS(X) 
1 50 SYSX 



Returns program flow to the line 
immediately following the subroutine 
call: subroutine exit, 

Stops program eKecution. 

Program flow is transferred to a 
machine language program at decimal 
address X 



1 50 UBR (Y) Passes a parameter Y in the floating 

point accumulator to a machine 
language routine pointed to by 
memorv locations 1 & 2. 



STATEMENTS: I/O 



^ATEMENT EXAMPLE 

CLOSE 1CX) CLOSET 

CMD 10 CMDT 

GET 20 GET AS 



DEFINITION 

Closes logical file T. 

Commands logical file T to monftor 
IEEE Bus 

Accepts s single string character 
Irom the keyboard. 



GET# 20GET*T.X 



INPUT 100 I^P^JT 

100 INPUT 
Y.R$.A% 

INPUT* 160 INPUT ^!T. 

Y.A.HS 



Accepts a single character from 
logical file T. 

Accepts a number for the variable V 
frorn the keyboard. 
Accepts a number, a string, and an 
integer from the keyboard. 

Accepts two numbers and a string 
from logical file T. 



LOAD 



40 LOAD 



SO LOAD 
"ABC", T 



Loads next file or program 
encountered on the built in cassette 
into memory. 

Loads program or file named "ABC" 
into memory from logical file T 



OPEN 10OOPENT. OpenslogicalfileTandassigns 

D,S. "NAME" device address D. secondary address 

S as well as a file name "NAME" to it 
I See I/O default table). 

PEEK 100A= PEEKjXI Returns decimal value of memory 

location X to A. 



POKE 



100 POI<' X. A 



Puts the quantity A into memory 
location X. 



PRINT 



PRINT* 



100 PRINTY' 
100 PRINT "V" 
100 PRINTYS. Y 



100 PRINT 
Y$: RS; A] 



ISO PRINT # T 
AS 



Prints the van able Y on the CRT. 
Prints the character "V" on the CRT. 
Prints the string, then tabs to the next 
tab stop no. 20. 30. 40 . .1 and 
prints the number 

Prims YS concatenated with RS. and 
the nunrber A separated by 3 spaces 
from R$. The carriage return is 
suppressed 

Prints vanablas A. 6 onto 

logical file T. 

NOTE: ? # is not valid 



200 I .DA, 
AS.CA* 



Assigns Ehese variables their values 
frcim the data statements. 



SAVE 



SAVE 



Saves the current program in 
memory on the buMi in cassette, no 
name is specified. 



64 


80 


32 


48 


192 


208 


160 


176 


CHRS 




144 


160 


176 


192 


208 


224 


240 


RVS 





16 


32 


48 


64 


80 


96 


112 


OFF 


















+ 


@ 


P 


SPACE 





B 


□ 


SPACE 


H 





A 

A 


Q 


1 


1 




■ 


n 


S 


1 


B 


R 




2 




□ 


B 


H 


2 


C 


S 


# 


3 


a 




□ 


ffl 


3 


D 


T 




4 


B 


□ 


□ 


C 


4 


E 


U 


% 


5 


B 




□ 


E 


5 


F 


V 


& 


6 


B 






[J 


6 


G 


w 


J 


7 


D 


D 


□ 


n 


7 


1 1 

H 


X 


( 


o 









H 


o 



1 

1 


Y 


) 


9 


□ 


a 


B 


H 


9 


1 

J 


z 






3 


♦ 


[1 


□ 


10 


K 


[ 


+ 






ffl 


[B 




11 


1 

L 


\ 


J 


< 


□ 


c 


□ 


a 


12 


ft Ji 

M 


] 






s 


m 




B 


13 


ft 1 

N 


t 




> 




7T 


□ 


E 


14 







/ 


7 


□ 


a 


U 


5 


15 



